Control Key Commands 
ENTER DATA AND PRODUCE REPORTS 


Cursor Control 


ctr! key Function 
D Character left 
X Down one line 
E Up one line 
S Character right 
F End of data area 
A Start of data area 


| (tab) Next data area 
“ (backtab) Previous data area 


Insert and Delete 


ctrl key Function 
V Toggle on/off character insert 
G Delete character at cursor position 
T Delete from cursor to end of word 
4 Delete data in current data area 


Scrolling and Paging 


ctrl key Function 
Cc Page forward 
R Page backward 


Browsing Indexes 
ctrl key Function 


B Toggle on edit mode 
Move cursor to indexed data area, enter data into area 
and then press return to position index. 


Z Display next record 

Ww Display previous record 
Other Controls 

Ctrl key Function 

O Delete current record 

ESC Exit 

Q Summon HELP text 

B Toggle add/edit mode 

P Print current form 

N Duplicate previous item 

U Replace current record on file 
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File Maintenance 
PEARLFM 


There are three main uses for file maintenance: 1) recovering unused disk space; 2) 
updating the index with form changes; and 3) maintaining separate design and 
production disks. To accomplish these tasks, six functions are provided: 


FILE SUMMARY DATA 
Displays file size and amount of unused space, version number and 
data record count. 


REBUILD INDEX 
Recreates index from the data file when design changes are made to 
indexed data areas. Restores file integrity in the event of malfunction. 


COMPACT DATA FILE 

Recovers unused disk space, verifies file integrity. 
CREATE DATA FILE 

This function will create a new empty production data file. 


TRANSFER FORM CHANGES 
Applies form design changes to production disks. Applicable only when 
maintaining separate design and production disks. 


TRANSFER PROGRAM CHANGES 
Applies form and report changes to production disks. Applicable only 
when maintaining separate design and production disks. 


Changing Form and Report Design 


When a form is reinstalled, it affects other parts of the system. Any reports which use 
information from the form must also be reinstalled. Similarly. if the form shares 
information with another form, that form must also be reinstalled. 


Form changes involving data areas defined as indexed areas will require that the 
index for the file be rebuilt. 


Messages will display in PEARLED and PEARLPR ff file maintenance is required. 
Disk File Types Used by PERSONAL PEARL 


PEARL.DIR Form directory 
(form name).S00 Form design information 
(form name).D00 Main data file 
(form name).E00 Index file 
(form name).LOO Data dictionary file 
(form name).DIR Report directory 
(report name).ROO Report design information 
(report name).MO0O0 Report dictionary file 
(form name).Q00 temporary work file 
(form name).KOO temporary work file 
(form name).TOO temporary work file 
(form name).V00 temporary work file 
(form name).PO0O temporary work file 
(form name).FOO temporary work file 


In most cases, temporary work files are automatically deleted when they are no longer 
needed. In some configurations work files may be left on disk by the system. 
Temporary work files may be deleted if encountered. 
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SYSTEM MAIN PROGRAMS 


PEARLUP 


PEARLDF 


PEARLDR 


PEARLI 


PEARLED 


PEARLPR 


PEARLFM 


PSORT 


System Configuration and Installation 
This program uses the information in the text file INSTALL.DAT to 
configure the system to match the hardware environment. Use a 
text editor to change configuration data in the INSTALL.DAT file for 
nonstandard setups. This program must be run to install the 
distributed PEARL program set before they will operate. 


Design Forms 
Used to design data input forms, or to modify existing forms. 


Design Reports 
Used to design reports, or to modify existing reports. 


Install Forms and Reports 
Translates design information into control information for later 
PEARLED and PEARLPR processing. This program is ‘chained to” 
from design forms and design reports. 

Enter Data 
This is the data entry program for forms which have been designed 
and installed. Use PEARLED to add or edit records in a data file. 
perform querries, or to print a singie form to the printer. 


Produce Reports 
This is the program which produces designed and installed 
reports. PEARLPR includes setting the runtime title, setting the 
record selection ranges, directing output to devices, and setting 
page formatting. 


File Maintenance 
File maintenance provides utilities for rebuilding indexes, com- 
pressing data files, creating new data files, examining file status, 
and maintaining separate design and production disks. 


Sort Utility 
This program is called automatically from PEARLPR as needed. 
PSORT may not be executed directly but must be called by 
PEARLPR. Sort sequence is set during report design in PEARLOR. 
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Control Key Commands 
DESIGN FORMS AND DESIGN REPORTS 


Cursor Control 


ctrl key 


nm>x< MON ?® 


Insert and Delete 


ctrl key 


<A Ss 


Function 


Home cursor 
Character ‘eft 
Character right 
Line up 

Line down 
Word left 
Word right 


Function 


Insert character mode, toggle on/off 
Insert one blank ‘ine 

Delete character at cursor position 
Delete from cursor to end of word 
Delete cursor line 


Scrolling and Paging 


ctrl key 


cSNDO 


Other controls 


ctrl key 


Function 


Page forward (group forward in list report design) 
Page backward (group backward in list report design) 
Scroll up 

Scroll down 

Scroll up from cursor position to top of screen 


Function 


Ignore edits and exit design step 
Delete entry from form or report directory 


Save and exit 
Summon HELP text 
Select data area for definition 


Print layout report (in step 1) 
Highlight indexed areas (in step 3) 
Highlight other form references (in step 4) 


Formatting Data Areas 
DESIGN FORMS AND DESIGN REPORTS, Step 1 


Character Areas 
Use underscores to indicate data areas. Separate data areas from 
background text with blanks. Background text may be used for 
punctuation. After a data area has been named in step 2, the spaces 
separating the data area from the background may be removed. 


Date Areas 
Use “mm/dd/yy” to format a date type data area. 


Numeric Areas 
Numeric areas may be formatted with the following punctuation: 


9 indicates digit position 
. may be used to group digits 
; indicates decimal point 
- in the last position, forces a trailing minus sign 
$ in the tirst position, provides a fixed dollar sign 
$$ in the first two positions, provides a floating dollar sign 


exampie: $ $999.999.99- this area will have a floating dollar 
sign. a trailing minus if negative. and will handle numbers up to 
one million dollars. A comma will group the digits dy threes. 
Amounts will be rounded off to the nearest cenit. 


Computations . 
DESIGN FORMS AND REPORTS, Step 2 


Operators in order of execution 
* = multiplication 
\ division 
+ addition 
- subtraction 


Nesting 
Parenthesis, “(" and “)" may be used to nest expressions 


External References 
Data areas from other forms may be used in computations if a path has 
be created to the external form. To reference the numeric data area 
from the other form, prefix its name by the name of its form followed by a 
period. 


example: 
TAX * ((HOURS * EMPMSTR.RATE) - DEDUCT1) 


In this example, the (external) other form, EMPMSTR is referenced. 


